package com.nidu.demo.oauth2.gateway;

import com.alibaba.cola.dto.PageResponse;
import com.nidu.demo.oauth2.model.OAuth2AccessToken;
import com.nidu.demo.oauth2.model.OAuth2AccessTokenCriteria;

import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * OAuth2访问令牌网关接口
 * 提供领域层对OAuth2访问令牌的访问能力
 *
 * @author auto
 */
public interface OAuth2AccessTokenGateway {

    /**
     * 创建OAuth2访问令牌
     *
     * @param accessToken OAuth2访问令牌信息
     * @return 创建后的OAuth2访问令牌
     */
    OAuth2AccessToken create(OAuth2AccessToken accessToken);

    /**
     * 更新OAuth2访问令牌
     *
     * @param accessToken OAuth2访问令牌信息
     * @return 更新后的OAuth2访问令牌
     */
    OAuth2AccessToken update(OAuth2AccessToken accessToken);

    /**
     * 根据ID查询OAuth2访问令牌
     *
     * @param id OAuth2访问令牌ID
     * @return OAuth2访问令牌信息
     */
    OAuth2AccessToken getById(Long id);

    /**
     * 根据访问令牌查询OAuth2访问令牌
     *
     * @param accessToken 访问令牌
     * @return OAuth2访问令牌信息
     */
    OAuth2AccessToken getByAccessToken(String accessToken);

    /**
     * 根据刷新令牌查询OAuth2访问令牌
     *
     * @param refreshToken 刷新令牌
     * @return OAuth2访问令牌信息
     */
    List<OAuth2AccessToken> getByRefreshToken(String refreshToken);

    /**
     * 删除OAuth2访问令牌
     *
     * @param id OAuth2访问令牌ID
     */
    void deleteById(Long id);

    /**
     * 批量删除OAuth2访问令牌
     *
     * @param ids OAuth2访问令牌ID列表
     */
    void deleteByIds(Set<Long> ids);

    /**
     * 分页查询OAuth2访问令牌
     *
     * @param criteria 查询条件
     * @return 分页结果
     */
    PageResponse<OAuth2AccessToken> pageByCondition(OAuth2AccessTokenCriteria criteria);

    /**
     * 列表查询
     * @param criteria 查询条件
     * @return OAuth2访问令牌列表
     */
    List<OAuth2AccessToken> listByCondition(OAuth2AccessTokenCriteria criteria);

    /**
     * 查询所有用户有效的OAuth2访问令牌
     * @return 用户OAuth2访问令牌Map
     */
    Map<Long, List<OAuth2AccessToken>> getAllValidTokens();
}